home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 1: Comms & Networking / Almathera Ten on Ten - Disc 1: Comms & Networking.iso / eff 'net guide / readme < prev    next >
Text File  |  1994-09-14  |  15KB  |  374 lines
  1. --- eegtti/$Id: README,v 2.3 1994/08/14 13:24:40 joke Rel $
  2.  
  3.  
  4. SPREAD THE WORD:
  5.  
  6.     "EFF's (Extended) Guide to the Internet is now available,
  7.      in a variety of easily convertible formats *and*
  8.      at your local laser printer."
  9.  
  10.  
  11.             -=- * -=-
  12.  
  13.     * WHAT IS EFF's (EXTENDED) GUIDE TO THE INTERNET?
  14.  
  15.    The extended version of The Guide is a Texinfo [t:ekinfo] (NOT TeXinfo!!)
  16. dition of a book once entitled "Big Dummy's Guide to the Internet", that
  17. was recently (July 1994) renamed to "EFF's Guide to the Internet." The latter
  18. is written by Adam Gaffin for a joint project of Apple Computer, Inc. and
  19. The Electronic Frontier Foundation (EFF). The extended version is a gift
  20. from the author of this FAQ to the EFF, and contains (a) the Guide, and
  21. (b) many more things either from the Net, or from the many kind souls who
  22. sent in their pieces.
  23.  
  24.             -=- * -=-
  25.  
  26.     * WHERE DO I GET THE HYPERCARD STACK?
  27.  
  28.    In the beginning (August 1993), Steve Cisler courtesy of the Apple Library,
  29. used a Macintosh computer and converted Adams original writing into a
  30. so-called HyperCard stack; this stack, readable by the HyperCard software
  31. that comes bundled with every Mac, is still available via anonymous FTP from
  32. EFF's server "ftp.eff.org" as file "/pub/Net_info/EFF_Net_Guide/bdgtti.hqx"
  33.  
  34. However, this version is completely out of date; if you're a passionate
  35. Apple/HyperCard hacker and want to volunteer in creating an up-to-date
  36. version, please send e-mail to ask@eff.org.
  37.  
  38.             -=- * -=-
  39.  
  40.     * ARE THERE MORE VERSIONS?
  41.  
  42.    Under "ftp.eff.org/pub/Net_info/EFF_Net_Guide/Other_versions/ there reside
  43. several other formats created by volunteers, e.g. AmigaGuide (Extended),
  44. MS-Windows Help (Orig), WordPerfect (Orig), SeeText (Macintosh) and GeoWorks
  45. Write (PC) formats. The latter by Adam himself (cf. VERSIONS below).
  46. Some contain the "Extended" text; some the original/core manual text only.
  47.  
  48.             -=- * -=-
  49.  
  50.     * AND THE ORIGINAL ASCII?  WHAT'S THE DIFFERENCE?
  51.  
  52.    Also available in the same directory is Adam's original ASCII
  53. version "netguide.eff" (currently at version 2.2) that served as the
  54. starting point for this Texinfo based release.
  55.  
  56. Besides several "bug fixes," witty quotes, corrections, including
  57. some complete rewrites (cf Chapter 8) and the new layout, some more
  58. value has been added; notably, two personal articles from EFFector
  59. Online, the EFF's bi-weekly news magazine (available in comp.org.eff.news
  60. on USENET), now serving as superb afterwords, and some other
  61. contribution of Netizens I found quite worthwhile reading over
  62. the past years:
  63.  
  64.             -=- * -=-
  65.  
  66.     * NOW, WHAT'S IN THERE?
  67.  
  68.    * "A Slice of Life in my Virtual Community" by Howard Rheingold
  69. describes the social life on the Internet from the WELL's point
  70. of view.
  71.  
  72.    * "A Statement of Principle" by SF author Bruce Sterling
  73. discusses some moral and legal issues you will definitely get to
  74. know when becoming a "cybernaut" on Internet.
  75.  
  76.    * "Preserving and Promoting the ``Internet Culture''" by Peter Deutsch
  77. explains some of the cultural background Netizens used to live in.
  78.  
  79.    * "Subject: TIME Article on Internet" by Philip Elmer-Dewitt
  80. shows , that even the non-virtual world (aka "reality") finally got
  81. interested in cyberspace, and the cybernauts on Internet.
  82.  
  83.    * "Subject: A Perspective on NREN" by Grag Chartrand *parodies*
  84. the NSF's proposed US National Education and Research Network.
  85.  
  86. Moreover a bibliography has been stuffed into this edition:
  87.  
  88.    * A comprehensive list of Paperware related to the Internet
  89. (This is an updated version of the bibliography section that
  90. comes with the first edition of "Zen and the Art of the
  91. Internet" by Brendan Kehoe, plus part of the reference section of
  92. Henry Edward Hardy's Master's Thesis "The History of the Net"
  93. written at the School of Communications, Grand Valley State
  94. University, Allendale, MI 49401. Version 7.2 was posted to
  95. comp.org.eff.talk on August 28, 1993). Kevin Savetz' "Unofficial
  96. internet Book List" will also find its way into this list, soon.
  97.  
  98.             -=- * -=-
  99.  
  100. This guide is same 260 European A4 size pages in length, (i.e. same 300
  101. US-letter size pages) and divided into the following sections:
  102.  
  103. * A 5 part Introduction
  104.  - G'day by the Texinfo editor
  105.  - Welcome by Mitchell Kapor, EFF
  106.  - Foreword by Mitchell Kapor, EFF
  107.  - Addendum to Foreword by Mitchell Kapor and Jerry Berman, EFF
  108.  - Preface by Adam Gaffin, Middlesex News, Boston, MA, USA.
  109.  
  110. * A 13 part Walk-trough-the-Internet
  111.  Chapter 1   -- Setting up, Getting connected, Jacking in...
  112.  Chapter 2   -- Electronic Mail
  113.  Chapter 3   -- Usenet: the Global Watering Hole
  114.  Chapter 4   -- Usenet: from Flame Wars to Killfiles
  115.  Chapter 5   -- Mailing Lists and Bitnet
  116.  Chapter 6   -- Telnet (Mining the Net, part I)
  117.  Chapter 7   -- FTP (Mining the Net, part II)
  118.  Chapter 8   -- Gophers, WAISs, and the World-Wide Web
  119.  Chapter 9   -- Advanced E-mail
  120.  Chapter 10  -- News of the World
  121.  Chapter 11  -- IRC, MUDs, and other things...
  122.  Chapter 12  -- Education on the Net
  123.  Chapter 13  -- Business on the Net
  124.  
  125. * A 6 part Afterword
  126.  - "Conclusion: the End?" by Adam Gaffin
  127.  - "A Slice of Life in my Virtual Community" by Howard Rheingold
  128.  - "A Statement of Principle" by Bruce Sterling
  129.  - "Preserving and Promoting the ``Internet Culture''" by Peter Deutsch
  130.  - "Subject: TIME Article on Internet" by Philip Elmer-Dewitt
  131.  - "Subject: A Perspective on NREN" by Greg Chartrand
  132.  
  133. * A Bibliography
  134.  - Paperware on the Internet: A comprehensive list of over
  135.    200 (sic!) literary references of books, papers, magazines,
  136.    newspaper bits, and electronically published texts, all of them
  137.    related to the Internet and similar topics.
  138.  
  139. * 5 Appendices
  140.  - Appendix on Internet Jargon
  141.  - Appendix by Ms. Emily Postnews
  142.  - Appendix on The Electronic Frontier Foundation
  143.  - Appendix on Internet Connectivity (ISO 3166/Internet Society)
  144.  - Appendix on Smileys: ``The Unofficial Smiley Dictionary''
  145.  
  146. * 4 Indices
  147.  - E-mail addresses mentioned
  148.  - Internet Sites mentioned
  149.  - Commands, Suffixes, and Tools mentioned
  150.  - General Index
  151.  
  152.  
  153.             -=- * -=-
  154.  
  155.     * WHY DO YOU WANT THIS?
  156.  
  157.    Why do you want this? Well, for one thing, it's better than Bloomfield's
  158. "99 more things to do in zero gravity", and then it's free. So what
  159. else do you expect? Ok, for an encore: it definitely saves you some time
  160. and trouble: traditionally users learned by word of mouth, stumbling
  161. upon things, being trapped by dozens of pitfalls, and laughed at by
  162. systems wizards. These times are OVER!
  163.  
  164. This guide should serve as a first straw to clutch at when you're stranded
  165. in this mindboggling universe called Internet; and are curious about what
  166. else can be done. It also presents the fundamental topics on a "rookie"
  167. level that are all too often assumed and considered trivial by many more
  168. experienced network users/admins/gurus.
  169.  
  170.             -=- * -=-
  171.  
  172.     * WHERE DO YOU GET IT?
  173.  
  174.    As mentioned before, it is available from the EFF's FTP server
  175. "ftp.eff.org" in the "pub/Net_info/EFF_Net_Guide/" directory.
  176.  
  177. Or check out the European default server "ftp.Germany.EU.net" in
  178. "pub/books/eff-guide". See below for instructions on "How to configure
  179. The Guide". AND read the SERVERS file that comes with the Texinfo distribution
  180. for more servers than you probably ever need...
  181.  
  182.             -=- * -=-
  183.  
  184.     * DISTRIBUTION DIRECTORY:
  185.  
  186.                  |-README                  // FAQ file
  187.                  |-README.VMS              // help for VMS folks
  188. |-extended-guide-|-eegtti-2.3.ps.gz        // PostScript
  189.                  |-eegtti-2.3.dvi.gz       // TeX DVI file
  190.                  |-eegtti-2.3-US.dvi.gz    // TeX DVI US paper
  191.                  |-eegtti-2.3-US.ps.gz     // TeX PS US paper
  192.                  |-eegtti-2.3.info.gz      // GNU Info file
  193.                  |-eegtti-2.3.txt.gz       // TEXT file
  194.                  |-eegtti-2.3.html.tar.gz  // HTML (WWW) files
  195.                  |-eegtti-2.3.amiga.lha    // AmigaGuide files
  196.                  |-eegtti-2.3.tar.gz       // all Texinfo sources
  197.  
  198. Both sites can uncompress the files "on the fly", i.e., you do not need to
  199. have the GNU gunzip utility. Just get the files with the ".gz" extension:
  200.  
  201.    get eegtti-2.3.ps
  202.  
  203. instead of:
  204.  
  205.    get eegtti-2.3.ps.gz
  206.  
  207.  
  208.             -=- * -=-
  209.  
  210.     * WHAT ARE ALL THESE FILES?
  211.  
  212.    Now, how to read it. The file eegtti-2.3.dvi is a DVI (DeVice
  213. Independent) file created by the TeX typesetting system. Filters
  214. exist to convert these DVI files into printer-specific files for
  215. a variety of printers. Also included is the file eegtti-2.3.ps,
  216. a PostScript version. eegtti-2.3.txt is the plain ASCII version
  217. of eegtti-2.3.info, ie. the latter can be browsed either using
  218. EMACS in INFO mode, or any GNU info browser, e.g. "info", or
  219. "xinfo". Just type "info -f eegtti-2.3.info" and there you go.
  220.  
  221. For the folks who want to print the PS version on a Hewlett-Packard
  222. laser printer with Postscript option, take care. You cannot print
  223. the file double-sided, which results in "0.5in upwards shifted" even pages;
  224. but printing it single-paged is ok. This is obvioulsy due to a bug in the
  225. HP-printer's firmware, and was reported by Ed Moore of HP, using a
  226. LaserJet 4Si (with PostScript option, of course).
  227.  
  228. Dawn Cooley reported troubles with a Texas Instruments microLaser Turbo.
  229. After downloading Adobe's error handler, The Guide printed fine.
  230.  
  231. The tar file with suffix ".html" contains The Guide in some 300 files in
  232. HyperText Markup Language format. They can be thrown into your
  233. system's World-Wide Web directory, and then browsed using the
  234. various WWW tools. E.g. from within NCSA Mosaic "Load Local" eeg_toc.html,
  235. and there you go! An alternative is to set the default home page environment
  236. variable with: "setenv WWW_HOME eeg_toc.html" which makes The Guide the
  237. HOME page (press the HOME button to get back to the top) on startup.
  238.  
  239. (Well, at least when NCSA Mosaic is installed on your system. If it's
  240. not, BUG YOUR SYSTEM ADMINISTRATOR! He obviously missed the
  241. leading edge of today's infosystems technologies.)
  242.  
  243. In the tar file eegtti-2.3.tar.gz (a gzip'ed tar file---ask
  244. YOUR LOCAL SYSTEM ADMINISTRATOR and/or Unix guru how to extract
  245. the files from this), there are a number of files suffixed by
  246. ".texi". These are all the Texinfo sources to this guide. A print-it-
  247. yourself-kit. If set-up properly you can make it print the Guide in
  248. any PostScript font you like. But we'll leave this as an excercise for
  249. the upcoming hacker generation.
  250.  
  251. New in the collection is eegtti-2.3.amiga.lha, an archive containing
  252. the AmigaGuide (cf VERSIONS below) version of the book.
  253.  
  254.             -=- * -=-
  255.  
  256.     * FYI: WHAT IS TeX?
  257.  
  258.    FYI: TeX is a free typesetting system by Don Knuth of Stanford;
  259. the source of which you can FTP or buy on a tape. Texinfo is a
  260. package of macros written on top of TeX by the GNU Project for
  261. easy manual creation. See the FTP Chapter in The Guide on how to
  262. obtain TeX (e.g. ftp.Germany.EU.net/pub/packages/TeX).
  263.  
  264.             -=- * -=-
  265.  
  266.     * HOW TO CREATE A DVI FILE?
  267.  
  268.    Well, first you must configure The Guide to produce an US letter
  269. size, or a European A4 paper size version: this can easily be done
  270. with the provided "configure" shell script (C-shell), eg.:
  271.  
  272.    example % configure --letter
  273. Or:
  274.    example % configure --a4
  275.  
  276. which results in the following message from "configure":
  277.  
  278. EFF's (Extended) Guide to the Internet [Texinfo edition 2.3, cm font]
  279. *** configured for A4 paper size.
  280.  
  281. Note, that "example %" represents your system's input prompt, that might look
  282. different for you, eg. on MS-DOS you're used to see something like
  283.  
  284.    C:\DUMMY>
  285.  
  286. You might also configure The Guide "by hand", e.g. for the letter size version:
  287.  
  288.    example % cp config/Makefile.us Makefile
  289.    example % cp config/eegtti.us eegtti.texi
  290.  
  291. And for the A4 version:
  292.  
  293.    example % cp config/Makefile.a4 Makefile
  294.    example % cp config/eegtti.a4 eegtti.texi
  295.  
  296. To create a DVI file of your own (e.g. to produce an A4 paper version),
  297. simply run "texi2dvi" on eegtti.texi twice; or use the Makefile included;
  298. it does almost *everything* for you (...although "make coffee" doesn't work,
  299. yet). All there is to do is to type:
  300.  
  301.    example % make dvi
  302.  
  303. It's really that easy! (If you have the appropriate tools installed, and
  304. a *real* operating system running on your box...)
  305.  
  306.             -=- * -=-
  307.  
  308.     * MORE ON CONFIGURATIONS?
  309.  
  310.    The general usage of the "configure" script is as follows:
  311.  
  312. usage: configure --<paper-size> --font <family>
  313.        --a4/--letter for <paper-size> (a4)
  314.        --font times/palatino/bookman/etc. for <family> (cm)
  315.  
  316. e.g.:  configure --a4 --font palatino
  317.  
  318. which results in the following message from "configure":
  319.  
  320. EFF's (Extended) Guide to the Internet [Texinfo edition 2.3, palatino font]
  321. *** configured for A4 paper size.
  322.  
  323. This means you can also set the PostScript font that are contained in the
  324. "fonts" directory; you must also have a recent version of Tom Rockicki's
  325. dvips(1) program installed on your system.
  326.  
  327.             -=- * -=-
  328.  
  329.     * WHAT ABOUT A GNU INFO FILE?
  330.  
  331.    Well, some moons have passed since edition 1.00, and now it's there!
  332. But you need to patch "makeinfo v1.55" with the included "makeinfo-1.55.
  333. patch" file, and compile it with "-DJOKES=1" defined. Then type "make info"
  334. for the Info, and "make txt" for a TEXT/ASCII version.
  335.  
  336.             -=- * -=-
  337.  
  338.     * HOW TO CREATE THE HTML FILES?
  339.  
  340.    Just say "make html" which runs "texi2html" on "eegtti.texi" and
  341. creates a bunch of HTML files; Note that "texi2html" needs Larry Wall's
  342. "perl" program to be installed on your system. Maybe you need to edit the
  343. first line in the perl script "#!/usr/local/bin/perl" to whatever
  344. directory "perl" is installed on your system. The next version won't need
  345. Lionel Cons' texi2html script anymore; Texinfo will support HTML+ in
  346. "native" mode!
  347.  
  348.             -=- * -=-
  349.  
  350.     * HOW TO HANDLE TYPOS, MISTAKES, AND OTHER BUGS?
  351.  
  352.    Given, that this is an ever changing effort, some "bugs" or other
  353. "quirks" are inevitable, that might have been overseen during Texinfo
  354. production. If you find something, drop me an e-mail; if you have any
  355. comments or questions, want to make further addition or corrections,
  356. please send "all-your-stuff" to the address below. I'll probably include
  357. them into future releases of this guide.
  358.  
  359.    Thanx in advance for your patience!
  360.  
  361.             -=- * -=-
  362.  
  363.     * THE CURRENT TEXINFO EDITOR/COORDINATOR?
  364.  
  365. Yours,    -joke
  366.  
  367.  ===    ____                          ===   Jörg Heitkötter
  368.  ===   /      /   /   ___    ___  _/_ ===   joke@Germany.EU.net
  369.  ===  /----  /   /  /   /  /___/  /   ===   EUnet Deutschland GmbH
  370.  === /____  /___/  /   /  /___   /    ===   Emil-Figge-Str. 80
  371.  =====                              =====   D-44227 Dortmund
  372.  ===== Connecting Europe since 1982 =====   Tel.(Fax) +49 231 972 2222 (1111)
  373.  
  374.